<?xml version="1.0" encoding="UTF-8"?>
<html filename="docs/SAX/IDTDHandler.html">
<body>
<a id="#top"/>
<h1>
	                Interface Summary : IDTDHandler </h1> Receive notification of basic DTD-related events.

 <blockquote>
 <em>This module, both source code and documentation, is in the
 Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
 </blockquote>

 <p>If a SAX application needs information about notations and
 unparsed entities, then the application implements this
 interface and registers an instance with the SAX parser using
 the parser's setDTDHandler method.  The parser uses the
 instance to report notation and unparsed entity declarations to
 the application.</p>

 <p>Note that this interface includes only those DTD events that
 the XML recommendation <em>requires</em> processors to report:
 notation and unparsed entity declarations.</p>

 <p>The SAX parser may report these events in any order, regardless
 of the order in which the notations and unparsed entities were
 declared; however, all DTD events must be reported after the
 document handler's startDocument event, and before the first
 startElement event.
 If the <a href="../SAX/ILexicalHandler.html">ILexicalHandler</a> is
 used, these events must also be reported before the endDTD event.)</p>

 <p>It is up to the application to store the information for
 future use (perhaps in a hash table or object tree).
 If the application encounters attributes of type &quot;NOTATION&quot;,
 &quot;ENTITY&quot;, or &quot;ENTITIES&quot;, it can use the information that it
 obtained through this interface to find the entity and/or
 notation corresponding with the attribute value.</p>

<br/><b>Since : </b> SAX 1.0
<br/><b>See : </b> <a href="../SAX/IXMLReader.html#setDTDHandler">IXMLReader.setDTDHandler</a>
<h2>
	              Methods
	            </h2>
<div style="padding-left:10px">
<a href="#notationDecl">
	                  procedure
	                 notationDecl(SAXString, SAXString, SAXString)</a>
<br/>
<a href="#unparsedEntityDecl">
	                  procedure
	                 unparsedEntityDecl(SAXString, SAXString, SAXString, SAXString)</a>
<br/>
</div>
<br/>
<hr width="100%"/>
<a name="#notationDecl">
<p>
<b>procedure</b> notationDecl(<b>const</b> name : SAXString; <b>const</b> publicId : SAXString; <b>const</b> systemId : SAXString); </p>
</a> Receive notification of a notation declaration event.

 <p>It is up to the application to record the notation for later
 reference, if necessary;
 notations may appear as attribute values and in unparsed entity
 declarations, and are sometime used with processing instruction
 target names.</p>

 <p>At least one of publicId and systemId must be non-empty.
 If a system identifier is present, and it is a URL, the SAX
 parser must resolve it fully before passing it to the
 application through this event.</p>

 <p>There is no guarantee that the notation declaration will be
 reported before any unparsed entities that use it.</p>

<br/><b>Parameter : </b> name The notation name.
<br/><b>Parameter : </b> publicId The notation's public identifier, or empty if
        none was given.
<br/><b>Parameter : </b> systemId The notation's system identifier, or empty if
        none was given.
<br/><b>Exception : </b> ESAXException Any SAX exception.
<br/><b>See : </b> <a href="../SAX/IDTDHandler.html#unparsedEntityDecl">IDTDHandler.unparsedEntityDecl</a>
<br/><b>See : </b> <a href="../SAX/IAttributes.html">IAttributes</a>
<br/>
<p>
<a href="#top">Top</a>
</p>
<hr width="100%"/>
<a name="#unparsedEntityDecl">
<p>
<b>procedure</b> unparsedEntityDecl(<b>const</b> name : SAXString; <b>const</b> publicId : SAXString; <b>const</b> systemId : SAXString; <b>const</b> notationName : SAXString); </p>
</a> Receive notification of an unparsed entity declaration event.

 <p>Note that the notation name corresponds to a notation
 reported by the <a href="../SAX/IDTDHandler.html#notationDecl">notationDecl</a> event.
 It is up to the application to record the entity for later
 reference, if necessary;
 unparsed entities may appear as attribute values.</p>

 <p>If the system identifier is a URL, the parser must resolve it
 fully before passing it to the application.</p>

<br/><b>Exception : </b> ESAXException Any SAX exception.
<br/><b>Parameter : </b> name The unparsed entity's name.
<br/><b>Parameter : </b> publicId The entity's public identifier, or empty if none
        was given.
<br/><b>Parameter : </b> systemId The entity's system identifier.
<br/><b>Parameter : </b> notationName The name of the associated notation.
<br/><b>See : </b> <a href="../SAX/IDTDHandler.html#notationDecl">IDTDHandler.notationDecl</a>
<br/><b>See : </b> <a href="../SAX/IAttributes.html">IAttributes</a>
<br/>
<p>
<a href="#top">Top</a>
</p>
</body>
</html>